// Copyright 2017 the V8 project authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef V8_SETUP_ISOLATE_H_
#define V8_SETUP_ISOLATE_H_

#include "src/base/macros.h"

namespace v8 {
namespace internal {

    class Builtins;
    class Code;
    class Heap;
    class Isolate;

    namespace interpreter {
        class Interpreter;
    } // namespace interpreter

    // This class is an abstraction layer around initialization of components
    // that are either deserialized from the snapshot or generated from scratch.
    // Currently this includes builtins and interpreter bytecode handlers.
    // There are two implementations to choose from at link time:
    // - setup-isolate-deserialize.cc: always loads things from snapshot.
    // - setup-isolate-full.cc: loads from snapshot or bootstraps from scratch,
    //                          controlled by the |create_heap_objects| flag.
    // For testing, the implementation in setup-isolate-for-tests.cc can be chosen
    // to force the behavior of setup-isolate-full.cc at runtime.
    //
    // The actual implementations of generation of builtins and handlers is in
    // setup-builtins-internal.cc and setup-interpreter-internal.cc, and is
    // linked in by the latter two Delegate implementations.
    class V8_EXPORT_PRIVATE SetupIsolateDelegate {
    public:
        explicit SetupIsolateDelegate(bool create_heap_objects)
            : create_heap_objects_(create_heap_objects)
        {
        }
        virtual ~SetupIsolateDelegate() = default;

        virtual void SetupBuiltins(Isolate* isolate);

        virtual bool SetupHeap(Heap* heap);

    protected:
        static void SetupBuiltinsInternal(Isolate* isolate);
        static void AddBuiltin(Builtins* builtins, int index, Code code);
        static void PopulateWithPlaceholders(Isolate* isolate);
        static void ReplacePlaceholders(Isolate* isolate);

        static bool SetupHeapInternal(Heap* heap);

        const bool create_heap_objects_;
    };

} // namespace internal
} // namespace v8

#endif // V8_SETUP_ISOLATE_H_
